#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
系统启动指南 - TDX每日定时调度系统
"""

STARTUP_GUIDE = """
╔════════════════════════════════════════════════════════════════════════════╗
║         TDX每日定时调度系统 - 快速启动指南                                  ║
╚════════════════════════════════════════════════════════════════════════════╝

【系统组成】
✓ archive_txt_files.py       - txt文件备份脚本（新建）
✓ scheduler_daily_tasks.py   - 核心调度脚本（新建）
✓ scheduler_quick_start.py   - 快速启动菜单（新建）
✓ SCHEDULER_README.md        - 完整文档（新建）

【立即使用】

方式1: 使用菜单界面（推荐）
────────────────────────────
  python3 scheduler_quick_start.py
  
  菜单选项：
  1. 启动调度器（每天下午4点自动执行）
  2. 执行一次测试（立即执行一遍完整流程）
  3. 显示日志
  4. 查看帮助
  5. 安装依赖
  0. 退出


方式2: 直接启动调度器
────────────────────────────
  # 启动调度器，每天16:00自动执行
  python3 scheduler_daily_tasks.py --mode start
  
  # 立即执行一次（用于测试）
  python3 scheduler_daily_tasks.py --mode test


方式3: 系统定时任务（Linux/Mac）
────────────────────────────
  编辑crontab:
  crontab -e
  
  添加以下行：
  0 16 * * * cd /Volumes/PatricData/Quant/quantData/tdxexport && python3 scheduler_daily_tasks.py --mode start


【执行流程】
────────────────────────────
每天下午16:00 (4点):
  1. tdx_control.py        ← 从通达信导出板块数据
  2. archive_txt_files.py  ← 备份txt文件到日期目录
  3. generate_blocks.py    ← 生成和过滤板块数据
  4. rgg_ana_lite.py       ← 生成RRG分析图表

日志保存到: scheduler.log


【快速测试】
────────────────────────────
1. 安装依赖（如果还没安装）:
   pip install schedule
   
2. 执行一次完整流程（不用等待4点）:
   python3 scheduler_daily_tasks.py --mode test
   
3. 查看执行结果:
   tail -50 scheduler.log


【关键信息】
────────────────────────────
✓ 所有脚本必须在同一目录下
✓ 调度器需要持续运行才能在指定时间执行
✓ 所有执行日志保存在 scheduler.log
✓ txt文件备份保存在 txt_archive/ 目录（按日期分类）
✓ 如果某个脚本失败，调度器不会停止后续执行
  （除非generate_blocks.py失败）


【修改执行时间】
────────────────────────────
编辑 scheduler_daily_tasks.py，找到这行：
  schedule.every().day.at("16:00").do(self.daily_task)

改为你想要的时间（如下午3点）:
  schedule.every().day.at("15:00").do(self.daily_task)


【常见问题】
────────────────────────────
Q: 如何停止调度器？
A: 按 Ctrl+C

Q: 如何查看执行日志？
A: tail -f scheduler.log（实时查看）
   或 cat scheduler.log | grep "2025-12-04"（查看特定日期）

Q: 如何验证系统是否正常？
A: python3 scheduler_daily_tasks.py --mode test

Q: 调度器没有在指定时间执行？
A: 检查系统时间、确认调度器还在运行、查看日志


【文件说明】
────────────────────────────

archive_txt_files.py
  - 将当前目录下的5个txt文件复制到txt_archive/日期目录
  - 文件名添加日期后缀
  - 单独执行: python3 archive_txt_files.py

scheduler_daily_tasks.py
  - 核心调度脚本
  - 包含DailyScheduler类，管理任务执行
  - 提供--mode参数选择启动或测试模式

scheduler_quick_start.py
  - 提供菜单界面
  - 便于不熟悉命令行的用户使用
  - 可自动安装依赖

SCHEDULER_README.md
  - 完整的系统文档
  - 包含故障排查、配置等详细信息


【首次设置检查清单】
────────────────────────────
□ 已安装Python 3.7+
□ 已安装schedule包: pip install schedule
□ 已验证tdx_control.py能正常运行
□ 已验证generate_blocks.py能正常运行
□ 已验证rgg_ana_lite.py能正常运行
□ 已执行测试: python3 scheduler_daily_tasks.py --mode test
□ 检查日志无错误: cat scheduler.log
□ txt_archive目录已生成，包含备份文件


【启动后的监控】
────────────────────────────
启动调度器后，建议：
1. 使用另一个终端监控日志: tail -f scheduler.log
2. 定期检查txt_archive目录是否有新的日期目录
3. 在16:00左右观察日志是否有执行记录

═══════════════════════════════════════════════════════════════════════════════
准备好了？立即执行：python3 scheduler_quick_start.py
═══════════════════════════════════════════════════════════════════════════════
"""

if __name__ == '__main__':
    print(STARTUP_GUIDE)
